@DATABASE PopShell @NODE "MAIN" "PopShell Dokumentation" @NEXT "INTRODUCTION" PopShell Version 6.9 * FreeWare Testversion * * ShareWare registrierte Version * @{ub} PopShell ist ShareWare und wurde der ffentlichkeit als eingeschr Testversion zur Verf gung gestellt. Die Einschr nkungen sollen nur ein Anreiz sein, sich registrieren zu lassen. Was f r Einschr nkungen hat die Testversion? Die Konfiguration kann nicht abgespeichert werden - dazu m ssen Sie dann eben Ihren Texteditor zu Hilfe nehmen. berhinaus erscheint bei jedem ffnen des Konfigurationsfensters ein Requester, um Sie daran zu erinnern, sich registrieren zu lassen. Das ist alles! Ist doch gar nicht so schlimm, oder? Aber hoffentlich st rend genug, Sie sich registrieren lassen... @{" hrung " link "INTRODUCTION"} Was ist PopShell? @{" Rechtliches " link "LEGALSTUFF"} Copyright und Vertrieb @{" Benutzung " link "HOWTOUSE"} Wie bedient man PopShell? @{" Kurzanleitung " link "QUICKSTART"} F r die, die etwas ungeduldiger sind... @{" Verschiedenes " link "MISCFEATURES"} Verborgene F higkeiten @{" Konfiguration " link "CONFIGFILE"} Erl uterungen zur Konfigurationsdatei @{" Installation " link "INSTALLATION"} Wie installiert man PopShell? @{" Registration " link "HOWTOREGISTER"} Wie wird man ein registrierter Benutzer? @{" Autoren " link "AUTHORS"} Wer entwickelte PopShell? @{" Danksagung " link "CREDITS"} Wir danken... @ENDNODE @NODE "INTRODUCTION" "Einf hrung" @NEXT "LEGALSTUFF" @PREV "MAIN" @TOC "MAIN" hrung: @{ub} PopShell erm glicht es Ihnen, jederzeit auf jedem beliebigen "Public Screen" eine Shell zu ffnen oder zu aktivieren. Dar ber hinaus kann PopShell auch selbst "Public Screens" ffnen und diese auch anderen Programmen zur Ver- gung stellen. Dies geschieht ber einen Eingriff in LockPubScreen(), der allerdings auch abschaltbar ist. Dies ist vor allem f r diejenigen unter Ihnen, die jegliche Eingriffe ins Betriebssystem f r ein Werk des Teufels halten... :-)) @{b}Anmerkung: @{ub} Ja, dies ist wirklich schon die sechste Version von PopShell! here Versionen wurden nicht ver ffentlicht oder nur einem begrenzten Personenkreis zur Verf gung gestellt. Dies hat sich nun ge ndert. Die lange Geschichte von PopShell: Die ersten drei Versionen waren komplett in Assembler geschrieben. V 1: (1991) einfaches Hilfsprogramm, das einen "Public Screen" ffnen kann. V 2: (1991) zus tzliche Option, um die Shell von PopShell aus zu starten. V 3: (1992) erste kleine Konfigurationsdateien f r Farben etc... r V3 und V4 wurde PopShell von Grund auf neu geschrieben. Dabei wurde nahezu ausschlie lich C verwendet. V 4: (1992) kleine Benutzeroberfl che mit eingeschr nkten M glichkeiten. V 5: (1993) Zweite, v llig neue Version mit aktuellem Konzept. V 6: (1994) Komplett aufger umt, neue Optionen und Optimierungen. @ENDNODE @NODE "LEGALSTUFF" "Rechtliches" @NEXT "HOWTOUSE" @PREV "INTRODUCTION" @TOC "MAIN" @{b}Copyright und Vertrieb: @{ub} PopShell ist geistiges Eigentum von @{"Tobias Abt" link "AUTHORS"} und @{"Alexander Kneer" link "AUTHORS"}. Die registrierte Version von PopShell darf nur von den Autoren weitergegeben werden. Die eingeschr nkte FreeWare Version darf aber unter der Voraussetzung, das Archiv vollst ndig erhalten bleibt, auf jedem beliebigen Weg verbreitet werden. Die Autoren gestatten ausdr cklich das Hinzuf gen von BBS-Werbung im Rootverzeichnis des Archivs. @{b}Folgende Files m ssen im Archiv vorhanden sein: @{ub} PopShell/PopShell PopShell/PopShell.config PopShell/catalogs/deutsch/PopShell.catalog PopShell/Docs.info PopShell/Docs/deutsch.info PopShell/Docs/deutsch/PopShell.guide PopShell/Docs/deutsch/PopShell.guide.info PopShell/Docs/english.info PopShell/Docs/english/PopShell.guide PopShell/Docs/english/PopShell.guide.info PopShell/icons/PopShell16.info PopShell/icons/PopShell4.info PopShell/Install-PopShell PopShell/Install-PopShell_Deutsch.info PopShell/Install-PopShell_English.info PopShell.info @{b}Disclaimer: @{ub} PopShell wurde mit aller n tigen Sorgfalt entwickelt. Es hat sich im dauerhaften Betrieb auf einer Vielzahl von Amigas sehr bew hrt. Trotzdem kann f r Datenverluste oder hnliche Widrigkeiten keine Haftung bernommen werden. @ENDNODE @NODE "HOWTOUSE" "Wie man PopShell bedient" @NEXT "QUICKSTART" @PREV "LEGALSTUFF" @TOC "MAIN" Die grafische Benutzeroberfl che PopShells besteht aus drei wichtigen Komponenten: - die @{"PopShell" link "POPSHELLS"} Objekte, - die @{"PopScreen" link "POPSCREENS"} Objekte und - die @{"Men s" link "MENUS"}. Das Konzept mit PopShell und PopScreen Objekten erm glicht v llige und schnelle Kontrolle ber die gesamte Konfiguration. Auf diese Weise kann der Benutzer leicht Shells und "Public Screens" seinen W nschen und Bed rfnissen anpassen. @ENDNODE @NODE "POPSHELLS" "PopShell Objekte" @NEXT "POPSCREENS" @PREV "HOWTOUSE" @TOC "MAIN" @{b}PopShell Objekte @{ub}beschreiben die Zusammenh nge zwischen den verschiedenen "Public Screens", den Tastenk rzeln und den dazugeh renden Shells. Konfigurationsparameter sind: - Objektname: nur f r Sie als Ged chtnisst - PopScreen: Name des dazugeh renden "Public Screens". In der Liste der PopScreens den gew nschten Schirm aus- w hlen und dann das Gadget anklicken. Der Name erscheint dann in dem Textfeld rechts davon. - Tastenk rzel: Dies ist die Tastenkombination f r dieses PopShell Objekt. Sie k nnen entweder das Gadget anklicken, um das Eingabefenster zu erhalten, oder sie direkt in das Stringgadget rechts vom Button eintippen. - Fenstertitel: Name des Konsolenfensters beim Start. Voreingestellt ist "AmigaShell". - Name der Shell: ... Voreingestellt ist "NewShell". - Name der Konsole: ... Voreingestellt ist "CON:" - Konsolenoptionen: Zus tzliche Optionen f r das Konsolenfenster. - Immer neue Shell: Hier wird eingestellt, ob das Dr cken der Tasten- kombination immer eine neue Shell startet, oder ob zuerst versucht werden soll, eine alte Shell auf diesem PopScreen zu aktivieren. Die Shells werden so gestartet: "X/Y/W/H//CLOSE//SCREEN" @ENDNODE @NODE "POPSCREENS" "PopScreen Objecte" @NEXT "MENUS" @PREV "POPSHELLS" @TOC "MAIN" @{b}PopScreen Objekte @{ub}werden ben tzt, um die "Public Screens", auf denen Shells ffnet werden sollen, einzustellen. Hier k nnen folgende Eigenschaften eingestellt werden: - Objektname: Dies ist der Name des "Public Screens". Wenn Sie auf den Button klicken, dann erscheint ein Auswahlfenster, in dem Sie einen der augenblicklich ge ffneten "Public Screens" ausw hlen k nnen. Die Namen sind sensitiv bez glich Gro -/Kleinschreibung! Ein besonderer Name ist "#FrontMost#", er symbolisiert den im Augenblick des Zugriffs vordersten "Public Screen". Dies ist sehr n tzlich f r Batchdateien und ARexx-Skripte. - Schirmtyp: (ben tigt asl.library V38+) ffnet Auswahlfenster f den Schirmtyp. Sie k nnen hier Breite, H he, Tiefe und Auto-Rollen einstellen. Voreingestellt ist 'HIRES'. - Farben: ffnet Farbeinstellfenster auf aktiven PopScreen. Hier k nnen bis zu 16 Farben eingestell werden (der Rest kann nicht vorkonfiguriert werden). ber das Men nnen IFF-Paletten (z.B. von DPaint) geladen und gespeichert werden. Farben k nnen nat rlich nur auf eigenen Schirmen eingestellt werden. Voreingestellt sind die Workbenchfarben. - Stifte: ffnet Fenster, um die Zuteilung der Farben zur graphischen Benutzeroberfl che auf diesem Schirm zu erlauben. Dies funktioniert nat rlich auch nur auf eigenen Schirmen. Voreingestellt sind die Standardsystempens. - Shells: Hier k nnen Sie bis zu vier verschiedene Fenster einrichten, die dann in der Reihenfolge ge ffnet werden. ber das Men nnen Sie verschieden Vor- gaben ausw hlen und wenn Sie mit Ihrer Wahl zufrieden sind, den augenblicklichen Stand merken. Voreinge- stellt ist ein Fenster, das den gesamten Schirm ohne Men zeile einnimmt. - Zeichensatz: Hiermit k nnen Sie den Zeichensatz ausw hlen, den der Schirm- und die Fenstertitel haben sollen. Der Name wird im Textfeld rechts davon dargestellt (z.B. "Courier.13.b" f r einen fetten Courier-Font mit 13 Punkten H he. Vorgabe ist Topaz 8. - Extern: Hier w hlen Sie, ob es sich bei diesem PopScreen um einen handelt, den PopShell ffnet und verwaltet, oder ob es ein von einem anderen Programm ge ffneter Schirm ist. Beispile f r externe PopScreens: "Workbench" und "#FrontMost#". Vorgabe: eigener Schirm - Raster: Dieser Schalter erm glicht es (unter KickStart 3.0 oder besser), den Schirm mit einem Raster zu hinter- legen. Dies funktioniert nat rlich nur mit eigenen Schirmen... - Uhr: Hier k nnen Sie die Uhr und die Speicheranzeige in der Titelleiste des PopScreens einschalten. Auch dies funktioniert nur mit eigenen Schirmen. Die PopScreens, die nicht 'extern' deklariert sind, werden von PopShell bei Bedarf ge ffnet und werden dann von einem separaten Task verwaltet, der die Uhr steuert und den Schirm schlie t, sobald das letzte Fenster darauf geschlossen wird. Dadurch kann PopShell beendet werden, auch wenn noch PopScreens offen sind. Die Uhr l t sich auch w hrend dem Betrieb an- und ausschalten. @ENDNODE @NODE "MENUS" "Men @PREV "POPSCREENS" @TOC "MAIN" Die @{b}Men s @{ub}sind f r globale Einstellungen: - Projekt: ffnen ...: Neue Konfiguration laden. - Speichern: Konfiguration unter zuletzt benutztem Namen speichern. Vorgabe ist "PopShell.config". Dies kann im Icon von PopShell eingestellt werden. Gespeichert werden kann nur in der registrierten Version! - Speichern als ...: hnlich zu Speichern, nur wird hier zuerst nach einem Namen f r die Datei gefragt. ber PopShell: ffnet Fenster mit ein paar Informationen. - Beenden: PopShell beenden. Aber wer will das schon? - Spezial: - PopShell activ: Hiermit kann der Commodities Broker von PopShell komplett desaktiviert werden, das hei t, die Tastenk rzel sind abgeschaltet. - Auto PubScreen: Schaltet den LockPubScreen()-Patch ein oder aus. Dieser erm glicht es, auch anderen Programmen, die sich auf "Public Screens" umlenken lassen, solche bei Bedarf zu ffnen. Desweiteren erscheinen dann auch die PopScreens, die nicht 'extern' sind, in der globalen Liste von "Public Screens". Dies hat zur Folge, da diese PopScreens auch f r andere Programme bekannt werden. Dies erm glicht es dann auch, Programme, die ein Auswahlfenster mit "Public Screens" zur Verf gung stellen, komfortabel umzu- lenken. - auf Vorgaben zur cksetzen: hiermit kann die Standardkonfiguration hergestellt werden. Dies beinhaltet einen PopScreen mit zwei PopShell Objekten. @ENDNODE @NODE "QUICKSTART" "Kurzanleitung" @NEXT "MISCFEATURES" @PREV "HOWTOUSE" @TOC "MAIN" Kurzanleitung: @{ub} Installieren und starten Sie PopShell (vorzugsweise von der Workbench). Um das Konfigurationsfenster zu ffnen, starten Sie PopShell nochmal, dr Sie das entsprechende Tastenk rzel (voreingestellt ist 'lcommand p' oder benutzen Sie "CX Exchange". Wenn Sie PopShell korrekt installiert haben, sehen Sie nun in der oberen H lfte des Fensters zwei PopShell Objekte ("GoShell" und "NewShell") sowie ein PopScreen Objekt in der unteren Fenster- lfte (PopScreen). Klicken Sie mal ein bi chen rum, um ein Gef lhl f r die Konfiguration zu bekommen... Kreieren Sie neue Objekte, l schen Sie die, die Sie nicht mehr wollen... Dies sollte eigentlich f r niemand, der schon etwas mit dem Amiga gearbeitet hat, ein Problem darstellen. Nehmen wir mal an, da Sie eine Shell auf der Workbench einrichten wollen. Dazu richten wir zuerst unter ein PopScreen Objekt ein. Klicken Sie bitte einmal auf "Neu". Nun sollte ein "Neues Screenobjekt" erstellt worden sein. Klicken Sie bitte nun auf "Objektname". Es erscheint ein Fenster, in dem auch "Workbench" erscheinen sollte, was Sie nun ausw hlen. Das PopScreen Objekt t nun "Workbench". Nun k nnen Sie verschiedene Fenster f r Shells definieren. Dazu w hlen Sie bitte "Shells". ber das Men nnen Sie dann Fenster dazugeben, l schen oder einfach den aktuellen Zustand merken. Jetzt erzeugen Sie noch ein PopShell Objekt (obere Fensterh lfte). W Sie "Neu" (oben!) und geben Sie dem Kind einen Namen, damit Sie sich sp daran erinnern k nnen, wof r das PopShell Objekt da ist... Dr cken Sie auf "PopScreen", dann sollte jetzt rechts davon "Workbench" erscheinen, ansonsten ssen Sie erst unten dieses Objekt aktivieren. Nun klicken Sie bitte auf Tastenk rzel, worauf sich ein Fenster ffnet, um das Tastenk rzel einzugeben (ein beliebtes K rzel ist z.B. 'Amiga'+ 'Esc'). Nun ist dieses Objekt schon einsetzbar. Sie k nnen aber noch weitere Parameter einstellen, wozu Sie aber besser erst mal die Anleitung durchlesen. Wenn Sie fertig konfiguriert haben, k nnen Sie nun, falls Sie die Version r registrierte Benutzer besitzen, Ihre Einstellungen speichern. @ENDNODE @NODE "MISCFEATURES" "Besonderheiten" @NEXT "CONFIGFILE" @PREV "QUICKSTART" @TOC "MAIN" Besondere F higkeiten von PopShell: @{ub} - Im Spezial-Men des Konfigurationsfensters gibt es den Eintrag "Auto PubScreen", der je nach Schalterstellung einen Patch f LockPubScreen() aktiviert. Falls aktiviert, wird bei Aufruf von LockPubScreen(xyz) der PubScreen 'xyz' bei Bedarf ge ffnet, falls er noch nicht offen ist und es einen Eintrag in der PopScreen-Liste namens 'xyz' gibt, der kein "Alien Screen" ist. Anwendung z.B. f AmigaGuide: 'Pubscreen=AmigaGuide' setzen, dann kommt AmigaGuide auf einem diesem Schirm hoch, falls es einen Eintrag namens AmigaGuide gibt. Dar berhinaus bieten dann auch einige Programme die M glichkeit, PopScreens direkt auszuw hlen. - Doppelklick auf einen Eintrg in der PopShell-Liste bewirkt den Aufruf des dazugeh renden Objekts. - Wenn die Shell schon vorne ist, wenn Sie das Tastenk rzel erneut tippen, dann wird der Schirm mit der Shell nach hinten gelegt. Dies erm glicht es, "mal kurz" auf einem anderen Schirm etwas nachzu- schauen. - Beim Start ber CLI k nnen au er den gleichen Argumenten wie bei den Icon-ToolTypes dar berhinaus auch noch den Namen eines PopShell Objektes angeben. Dieses wird dann nach dem Start sofort gestartet. @ENDNODE @NODE "CONFIGFILE" "Erl uterung der Konfigurationsdatei" @NEXT "INSTALLATION" @PREV "MISCFEATURES" @TOC "MAIN" Die @{b}Konfigurationsdatei @{ub}ist eine einfach lesbare Textdatei und ist folgenderma en aufgebaut: Jede Zeile ist ein Eintrag in einem der folgenden Formaten: -AUTOOPENSCREEN=TRUE/FALSE: f r @{"LockPubScreen-Patch" link "MISCFEATURES"}, -"POPSCREEN:...": f r @{"PopScreen-Objekte" link "HOWTOUSE"}, -"POPSHELL:...": f r @{"PopShell-Objekte" link "HOWTOUSE"}. -"#...": f r Kommentare... Jeder Eintrag mu in genau eine Zeile (wegen ReadArgs())! Die ReadArgs()-Templates und ihre Beschreibung: ----------------------------------------------- POPSCREEN: NAME=N/K/A,MODE=M/K,WIDTH=W/N/K,HEIGHT=H/K/N, DEPTH=D/K/N,AUTOSCROLL=AS/S,PALETTE=P/K,PENS/K, FONT=F/K,CLOCK/S,ALIEN/S,BACKFILL/S,SHELLS/K POPSHELL: NAME=N/K/A,SCREEN=SC/K/A,HOTKEY=H/K/A, WINDOWTITLE=WT/K,SHELLNAME=SN/K,CONNAME=CN/K, CONPARA=CP/K,NEW/S Beispiel-Konfigurationsdatei (das sind auch gleich die Vorgaben) ---------------------------------------------------------------- # $VER: PopShell.config V1.0 written by PopShell V6.9 # PopShell configuration file AUTOOPENSCREEN=TRUE POPSCREEN:NAME="PopScreen" MODE=$8000 WIDTH=-1 HEIGHT=-1 DEPTH=2 AUTOSCROLL PALETTE="" PENS="1" FONT="topaz.8" CLOCK BACKFILL SHELLS="-1,-1,-1,-1" POPSHELL:NAME="GoShell" SCREEN="PopScreen" HOTKEY="lcommand esc" WINDOWTITLE="" SHELLNAME="" CONNAME="" CONPARA="" POPSHELL:NAME="NewShell" SCREEN="PopScreen" HOTKEY="lalt esc" WINDOWTITLE="" SHELLNAME="" CONNAME="" CONPARA="" NEW ---------------------------------------------------------------- @ENDNODE @NODE "INSTALLATION" "Installation" @NEXT "HOWTOREGISTER" @PREV "CONFIGFILE" @TOC "MAIN" Installation: @{ub} PopShell ist ein Commodity welches am besten im 'SYS:WBStartup'-Verzeichnis ihrer Workbench aufgehoben ist. Das beiligende Installationsskript (ben den 'Installer' von Commodore, welcher auf der Installationsdiskette Ihrer Workbench zu finden ist) nimmt Ihnen praktisch alles ab. Dieses stellt auch automatisch alle ToolTypes richtig ein, weshalb es wirklich zu empfehlen ist, dieses auch zu ben tzen! ToolTypes: @{ub} In den ToolTypes kann man au er den Standardeintr gen f r Commodities (CX_PRIORITY,CX_POPUP,CX_HOTKEY) und den Eintr gen f r WBStartup-Programme (DONOTWAIT,STARTPRI) noch den Eintrag CONFIGNAME benutzen, der den Namen der @{"Konfigurationsdatei" link "CONFIGFILE"} festlegt (Vorgabewert: PopShell.config). @ENDNODE @NODE "HOWTOREGISTER" "Wie wird man registrierter Benutzer?" @NEXT "AUTHORS" @PREV "INSTALLATION" @TOC "MAIN" Es gibt mehrere Wege, registrierter Benutzer von PopShell zu werden: @{b}a) @{ub}Senden Sie uns Geld! Erforderlicher Betrag f r die Registrierung und Zusendung der Version r registrierte Benutzer: DM 15. Updates kosten DM 5. Benutzer, die ber EMail erreichbar sind, bekommen Updates umsonst zugemailt. Falls Sie PopShell per EMail zugeschickt haben wollen, sagen Sie bitte, ob Sie nur das Programm oder aber das ganze Archiv wollen (wegen dem geringeren Datenaufkommen). Sie k nnen uns diesen Betrag auf mehrere Arten zukommen lassen: - Senden Sie Euroschecks oder Schecks von deutschen Banken. - berweisen Sie den Betrag auf das Konto von @{"Tobias Abt" link "AUTHORS"}, Sparkasse Ulm, BLZ 630 500 00, Kto. 256 861 @{b}und @{ub}senden Sie mir (Tobias Abt) dazu noch einen Brief mit Ihrer Adresse und einem Hinweis auf die berweisung, damit ich diese identifizieren kann. @{b}b) @{ub} bersetzen Sie PopShell (inklusive Dokumentation und Installation- skript) in eine noch nicht unterst tzte Sprache. Kl ren Sie dies bitte vorher ab, damit nicht f nf Leute f r die gleiche Sprache bersetzen... @{b}c) @{ub}Bieten Sie uns registrierte Versionen Ihrer eigenen Programme an. Dies gilt dar berhinaus auch f r FreeWare. Die Absicht hinter diesem Angebot ist, jene, die selbst schon etwas f r den Amiga auf die Beine gestellt haben, zu belohnen. Wir behalten uns allerdings das Recht vor, Ihr Programm abzulehnen, da auch wir nicht alles brauchen k nnen und es wirklich massenhaft unn tze Programme gibt... Also bitte erst mit uns abkl @{b}d) @{ub}Sie sind jemand, der auf andere Art und Weise etwas f r den Amiga getan hat? Wenn Sie sich daf r halten und wir Ihnen zustimmen, dann nnen auch Sie umsonst registrierter Benutzer werden. Wenn Sie mit uns Kontakt aufnehmen wollen, dann verwenden Sie doch bitte EMail! @{"EMail" link "AUTHORS"} wird schneller transportiert und bearbeitet und verursacht Ihnen und uns selbst weniger Kosten... @ENDNODE @NODE "AUTHORS" "Autoren" @NEXT "CREDITS" @PREV "HOWTOREGISTER" @TOC "MAIN" Diese Seite ist den @{b}Autoren @{ub}von PopShell gewidmet... PopShell wurde von Tobias Abt Bessererstra 89073 Ulm Deutschland Telefon: ++49/731/63366 (nur am Wochenende) EMail: zcjc1121@rpool1.rus.uni-stuttgart.de IRC: tabt@#AmigaGer Alexander Kneer Masurenweg 6a 89233 Neu-Ulm Pfuhl Deutschland Telefon: ++49/731/712490 EMail: leider keine vorhanden wegen der Unf higkeit der System- administratoren in der Fakult t Informatik der Uni Ulm. entwickelt. PopShell basiert auf einer Idee von Ralph Mayer, der auch an den ersten Versionen mitgearbeitet hat. @ENDNODE @NODE "CREDITS" "Dankesch @PREV "AUTHORS" @TOC "MAIN" Unser Dank gilt: @{ub} unseren Betatestern (in alphabetischer Reihenfolge): Angela, Felix, G nther, Ingmar, Jens, Lothar, Mats, Michael, Oly, Ralph, Thomas und jenen, die ich vergessen habe; Commodore Amiga f r den Amiga (schade da es so ausging...), SAS f r Ihren guten C-Compiler, Michael D. Bayne f r seinen GarshneBlanker, Oliver Bausch und Frank Sautter f r das oMniBus VGA system und allen anderen, die mit Ihren Programmen den Amiga so einzigartig gemacht haben und auch immer noch machen. @ENDNODE